Expressions/pl

Other languages:

Informacje ogólne

Możliwe jest definiowanie właściwości za pomocą wyrażeń matematycznych. W GUI, pola wyboru lub pola wejściowe, które są powiązane z właściwościami pokazują niebieską ikonę , gdy są aktywowane. Kliknięcie ikony lub wpisanie znaku równości = otwiera edytor wyrażeń dla danej właściwości. Jeśli pole wejściowe pokazuje przycisk ... zamiast ikony, edytor wyrażeń można otworzyć, klikając właściwość prawym przyciskiem myszy i wybierając Wyrażenie ... z menu podręcznego.

Wyrażenie FreeCAD jest wyrażeniem matematycznym zgodnym z notacją dla standardowych operatorów matematycznych, funkcji oraz predefiniowanych stałych opisanych poniżej. Dodatkowo, wyrażenie może odwoływać się do innych wyrażeń warunkowych, a także używać warunków. Liczby w wyrażeniu mogą mieć opcjonalnie dołączoną jednostkę.

W liczbach można używać przecinka , lub kropki dziesiętnej . oddzielającej całe cyfry od części dziesiętnych. Gdy używany jest przecinek, po nim musi następować co najmniej jedna cyfra. Zatem wyrażenia 1.+2. i 1,+2, są nieprawidłowe, ale 1.0 + 2.0 i 1,0 + 2,0 są już poprawne.

Operatory i funkcje są świadome jednostek i wymagają poprawnych kombinacji jednostek, jeśli zostały podane. Na przykład, 2mm + 4mm jest poprawnym wyrażeniem, podczas gdy 2mm + 4. Dotyczy to również odwołań do właściwości obiektu, które mają jednostki, takie jak właściwości Długości. Tak więc Pad001.Length + 1 jest wyrażeniem nieprawidłowym, ponieważ dodaje czystą liczbę do właściwości z jednostkami długości, konieczne jest użycie Pad001.Length + 1mm.

Niektóre błędy związane z jednostkami mogą wydawać się nieintuicyjne, z wyrażeniami albo są odrzucane, albo dają wyniki, które nie pasują do jednostek ustawianej właściwości. Oto kilka przykładów:

1/2mm nie jest interpretowany jako pół milimetra, ale jako 1/(2mm), co daje: 0,5 mm^-1.

sqrt(2)mm nie jest prawidłowe, ponieważ wywołanie funkcji nie jest liczbą. Należy to wprowadzić jako sqrt(2) * 1mm.

Argumenty funkcji

Wiele argumentów funkcji może być oddzielonych średnikiem ; albo przecinkiem, po którym następuje spacja , . W tym drugim przypadku, po wprowadzeniu przecinek jest konwertowany na średnik. Gdy używany jest średnik, spacja nie jest wymagana.

Argumenty mogą zawierać odwołania do komórek w arkuszu kalkulacyjnym. Odwołanie do komórki składa się z wielkiej litery wiersza, po której następuje numer kolumny, na przykład A1. Można też odwołać się do komórki, używając jej aliasu, na przykład Arkusz_kalkulacyjny.DługośćCzęści.

Odwołania do obiektów

Jak pokazano powyżej, można odwoływać się do obiektu poprzez jego DANENazwa. Ale można również użyć jego DANEEtykiety. W przypadku właściwości DANEEtykieta, musi ona być zamknięta w podwójnych symbolach << i >>, na przykład <<Etykieta>>.

Można odwołać się do dowolnej właściwości obiektu. Na przykład, aby odwołać się do wysokości bryły walca, możesz użyć właściwości Cylinder.Height lub <<Etykieta_walca>>.Height.

Więcej informacji na temat odwoływania się do obiektów znajdziesz w akapicie Odwołanie do danych CAD.

Operator	Opis
+	Dodawanie
-	Odejmowanie
*	Mnożenie
/	Dzielenie zmiennoprzecinkowe
%	Modulo
^	Potęgowanie

Funkcja	Opis	Zakres wprowadzanych wartości
`acos(x)`	Arc cosine	-1 <= x <= 1
`asin(x)`	Arc sine	-1 <= x <= 1
`atan(x)`	Arc tangent, zwraca wartość w zakresie > -90° do < 90°	cały
`atan2(y; x)`	Arc tangent z "y/x" z uwzględnieniem kwadrantu, zwraca wartość w zakresie > -180° do <= 180°	cały, nieprawidłowe dane wejściowe x = y = 0, zwracają 0
`cos(x)`	Cosine	cały
`cosh(x)`	Hyperbolic cosine	cały
`sin(x)`	Sine	cały
`sinh(x)`	Hyperbolic sine	cały
`tan(x)`	Tangent	cały, z wyjątkiem x = n*90 przy n = nieparzysta liczba całkowita
`tanh(x)`	Hyperbolic tangent	cały
`hypot(x; y)`	dodatek Pitagorejski (hypotenuse). Np. hypot(4; 3) = 5.	x oraz y >= 0
`cath(x; y)`	Biorąc pod uwagę przeciwprostokątną i jeden bok, zwraca drugi bok trójkąta. Np. cath(5; 3) = 4.	x oraz x >= y >= 0

Funkcja	Opis	Zakres wprowadzanych wartości
`exp(x)`	Funkcja wykładnicza	cały
`log(x)`	Logarytm naturalny	x > 0
`log10(x)`	Logarytm dziesiętny	x > 0
`pow(x; y)`	Potęgowanie	cały
`sqrt(x)`	Pierwiastek kwadratowy	x >= 0
`cbrt(x)` dostępne w wersji 0.21	Pierwiastek sześcienny	cały

Funkcja	Opis	Zakres wprowadzanych wartości
`abs(x)`	Wartość bezwzględna	cały
`ceil(x)`	Funkcja sufitu, najmniejsza wartość całkowita większa lub równa x	cały
`floor(x)`	Funkcja podłogi, największa wartość całkowita mniejsza lub równa x	cały
`mod(x; y)`	Reszta po podzieleniu "'x'" przez "'y', znak wyniku to znak dywidendy.	cały, z wyjątkiem y = 0
`round(x)`	Zaokrąglanie do najbliższej liczby całkowitej	cały
`trunc(x)`	Obcinanie do najbliższej liczby całkowitej w kierunku zera	cały

Funkcja	Opis	Zakres wprowadzanych wartości
`average(a; b; c; ...)`	Średnia wartość argumentów, tak samo jak sum(a; b; c; ...) / count(a; b; c; ...)	cały
`count(a; b; c; ...)`	Zlicz wartość argumentów, zwykle używane dla zakresów komórek	cały
`max(a; b; c; ...)`	Maksimum wartość argumentów	cały
`min(a; b; c; ...)`	Minimum wartość argumentów	cały
`stddev(a; b; c; ...)`	Odchylenie standardowe wartości argumentów	cały
`sum(a; b; c; ...)`	Suma wartości argumentów, typowo stosowane dla zakresów komórek	cały

Typ	Funkcja	Opis
`Tuple`	`tuple(a; b; ...)`	Przykład: `tuple(2; 1; 2)`
`List`	`list(a; b; ...)`	Przykład: `list(2; 1; 2)`
`Vector`	`vector(x; y; z)`	Utwórz wektor używając trzech wartości jednostkowych bez jednostek lub `Długości`. Przykład: `vector(2; 1; 3)`
`Vector`	`create(<<vector>>; x; y; z)`
`Matrix`	matrix( a₁₁; a₁₂; a₁₃; a₁₄; a₂₁; a₂₂; a₂₃; a₂₄; a₃₁; a₃₂; a₃₃; a₃₄; a₄₁; a₄₂; a₄₃; a₄₄ )	Create a 4x4 matrix in row-major order: ${\begin{bmatrix}a_{11}&a_{12}&a_{13}&a_{14}\\a_{21}&a_{22}&a_{23}&a_{24}\\a_{31}&a_{32}&a_{33}&a_{34}\\a_{41}&a_{42}&a_{43}&a_{44}\\\end{bmatrix}}$ Można podać minimum 1 argument, np. `matrix(1)`, który tworzy macierz tożsamości. Przykład: `matrix(1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)`
`Matrix`	`create(<<matrix>>; a₁₁; a₁₂; ...; a₄₄)`
`Rotation`	`rotation(axis; angle)`	Utwórz `Rotation` określając jego `axis`. (`Vector`) i `angle` (`Angle` jednostkowy lub bezjednostkowy), lub trzy kąty Eulera. `α`, `β`, `γ`. Przykład: `rotation(vector(0; 1; 0); 45)` `create(<<rotation>>; 30; 30; 30)`
	`rotation(α; β; γ)`
	`create(<<rotation>>; axis; angle)`
	`create(<<rotation>>; α; β; γ)`
`Placement`	`placement(base; rotation)`	Utwórz `Placement` z różnymi parametrami, w tym: `base`: położenie podstawowe (`Vector`) `center`: położenie środka (`Vector`) `rotation`: `Rotation` `axis`: oś obrotu (`Vector`) `angle`: kąt obrotu (unit-less or `Angle` unit value) `matrix`: `Matrix` Przykład: `placement(vector(2; 1; 3); rotation(vector(0; 0; 1); 45))` `create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))`
	`placement(base; rotation; center)`
	`placement(base; axis; angle)`
	`placement(matrix)`
	`create(<<placement>>; ...)`

Funkcja / Operator	Opis
`v1 + v2`	Dodaj dwa wektory.
`v1 - v2`	Odejmowanie dwóch wektorów.
`v * s`	Jednolite skalowanie wektora przez `s`.
`vangle(v1; v2)`	Kąt między dwoma wektorami w stopniach.
`vcross(v1; v2)`	Iloczyn krzyżowy dwóch wektorów $v_{1}\times v_{2}$ .
`v1 * v2`	Iloczyn kropkowy dwóch wektorów $v_{1}\cdot v_{2}$ .
`vdot(v1; v2)`	Iloczyn kropkowy dwóch wektorów $v_{1}\cdot v_{2}$ .
`vlinedist(v1, v2, v3)`	Odległość między wektorem `v1` a linią przechodzącą przez `v2` w kierunku `v3`.
`vlinesegdist(v1; v2; v3)`	Odległość między wektorem `v1` a najbliższym punktem na odcinku linii od `v2` do `v3`.
`vlineproj(v1; v2; v3)`	Rzutuj wektor `v1` na linię przechodzącą przez `v2` w kierunku `v3`.
`vnormalize(v)`	Normalizuje wektor do wektora jednostkowego.
`vplanedist(v1)`	Odległość między wektorem `v1` a płaszczyzną zdefiniowaną przez punkt `v2` i normalną `v3`.
`vplaneproj(v1)`	Rzutuje wektor `v1` na płaszczyznę zdefiniowaną przez punkt `v2` i normalną `v3`.
`vscale(v; sx; sy; sz)`	Niejednolite skalowanie wektora przez `sx` w kierunku X, `sy` w kierunku Y i `sz` w kierunku Z.
`vscalex(v; sx)`
`vscaley(v; sy)`
`vscalez(v; sz)`

Funkcja	Opis
`minvert(m)`	Oblicz Inverse matrix.
`mrotate(m; rotation)`	Rotate przez: `Rotation` oś (`Vector`) i kąt (`Angle` jednostkowy lub bezjednostkowy) trzy kąty Eulera `α`, `β`, `γ`
`mrotate(m; axis; angle)`
`mrotate(m; α; β; γ)`
`mrotatex(m; angle)`	Rotate wokół osi X.
`mrotatey(m; angle)`	Rotate wokół osi Y.
`mrotatez(m; angle)`	Rotate wokół osi Z.
`mtranslate(m; vector)`	Przekształć za pomocą `vector` (`Vector`) lub wartości X, Y, Z. Jeśli przekształcenie dotyczy `Rotation`, zwróconym obiektem jest `Placement`.
`mtranslate(m; x; y; z)`
`mscale(m; vector)`	Skaluj za pomocą `vector` (`Vector`) lub wartości X, Y, Z.
`mscale(m; x; y; z)`	Skaluj za pomocą `vector` (`Vector`) lub wartości X, Y, Z.

Operator	Opis
==	jest równy
!=	nie jest równy
>	większy niż
<	mniejszy niż
>=	większy lub równy
<=	mniejszy lub równy

Jednostka	Opis
°	Stopień; alternatywa dla jednostki deg
deg	Stopień; alternatywa dla jednostki °
rad	Radian
gon	Gradian
M	Minuta kątowa, alternatywa dla jednostki '
′	Minuta kątowa; alternatywa dla jednostki M
S	Second of arc; NIE DZIAŁA; alternatywa dla jednostki ″
″	Second of arc; to jest podwójny znak prim (U+2033); alternatywa dla jednostki S

Nazwa stałej	Opis
e	Liczba Eulera
pi	Pi

Jednostka	Opis
mmol	MilliMasa molowa
mol	Mol

Jednostka	Opis
mA	Milliamper
A	Amper
kA	Kiloamper
MA	Megaamper

Jednostka	Opis
pF	Pikofarad,
nF	Nanofarad,
uF	Mikrofarad; alternatywa dla jednostki µF,
µF	Mikrofarad; alternatywa dla jednostki uF,
mF	Millifarad,
F	Farad; 1 F = 1 s^4·A^2/m^2/kg,

Jednostka	Opis
uS	Microsiemens; alternatywa dla jednostki µS
µS	Microsiemens; alternatywa dla jednostki uS
mS	Millisiemens
S	Siemens; 1 S = 1 s^3·A^2/kg/m^2
kS	KiloSiemens
MS	MegaSiemens

Jednostka	Opis
nH	Nanohenr,
uH	Mikrohenr; alternatywa dla jednostki µH,
µH	Mikrohenr; alternatywa dla jednostki uH,
mH	Millihenr,	H	[v Henry]; 1 H = 1 kg·m^2/s^2/A^2,

Jednostka	Opis
mJ	MilliDżul
J	Dżul
kJ	KiloDżul
eV	Elektronowolt, 1 eV = 1.602176634e-19 J
keV	KiloElektronowolt
MeV	MegaElektronowolt
kWh	Kilowatogodzina, 1 kWh = 3.6e6 J
Ws	Watosekunda, alternatywa dla jednostki Dżul
VAs	Woltoamperosekunda, alternatywa dla jednostki Dżul
CV	Kulomb-wolt, alternatywa dla jednostki Dżul
cal	Kaloria, 1 cal = 4.184 J
kcal	KiloKaloria

Jednostka	Opis
nm	Nanometr
mu	Micrometr, alternatywa dla jednostki µm
µm	Micrometr, alternatywa dla jednostki mu
mm	Millimetr
cm	Centimetr
dm	Decimetr
m	Metr
km	Kilometr
mil	Tysięczne części cala, alternatywa dla jednostki thou
thou	Tysięczne części cala, alternatywa dla jednostki mil
in	Cal, alternatywa dla jednostki "
"	Cal, alternatywa dla jednostki in
ft	Stopa, alternatywa dla jednostki '
'	Stopa, alternatywa dla jednostki ft
yd	Jard
mi	Mila

Jednostka	Opis
ug	Microgram, alternatywa dla jednostki µg
µg	Microgram, alternatywa dla jednostki ug
mg	Milligram
g	Gram
kg	Kilogram
t	Tona
oz	Uncja
lb	Funt, alternatywa dla jednostki lbm
lbm	Funt, alternatywa dla jednostki lb
st	Kamień
cwt	Waga stu-kilowa (kwintał)

Jednostka	Opis
Pa	Paskal
kPa	Kilopaskal
MPa	Megapaskal
GPa	Gigapaskal
uTorr	Microtor, alternatywa dla jednostki µTorr
µTorr	Microtor, alternatywa dla jednostki uTorr
mTorr	Millitor
Torr	Tor; 1 Torr = 133.32 Pa
psi	Funt na cal kwadratowy; 1 psi = 6.895 kPa
kpsi	KiloFunt na cal kwadratowy

Jednostka	Opis
uK	Microkelwin, alternatywa dla jednostki µK
µK	Microkelwin, alternatywa dla jednostki uK
mK	Millikelwin
K	Kelwin

Jednostka	Opis
s	Second
min	Minuta
h	Godzina
Hz (1/s)	Herc
kHz	KiloHerc,
MHz	MegaHerc
GHz	GigaHerc
THz	TeraHerc

Jednostka	Opis	Zamiennik
°C	Celsjusz	[°C] + 273.15 K
°F	Fahrenheit;	([°F] + 459.67) × 5/9
u	Jednostka masy atomowej, alternatywa dla jednostki Da	1.66053906660e-27 kg
Da	Dalton, alternatywa dla jednostki u	1.66053906660e-27 kg
sr	Steradian	nie bezpośrednio
lm	Lumen	nie bezpośrednio
lx	Luks	nie bezpośrednio
px	Piksel	nie bezpośrednio

Znak / Ciąg znaków	Opis
+, -, *, /, ^, _, <, >, (, ), {, }, [, ], ., ,, =	Znaki, które są operatorami matematycznymi lub częścią konstrukcji matematycznych
A, kA, mA, MA, J, K, ' , ft , °, i wiele więcej!	Znaki i ich ciągi, które są jednostkami, (patrz akapit Jednostki)
#, !, ?, §, $, %, &, :, ;, \, \|, ~, ∆, ¿, i wiele więcej!	Znaki używane jako symbol listy lub wyzwalają specjalne operacje
pi, e	Stałe matematyczne
´, `, ' , "	Znaki używane do akcentowania
spacja	Spacja określa koniec nazwy i dlatego nie może być użyta

Expressions/pl

Informacje ogólne

Argumenty funkcji

Odwołania do obiektów

Obsługiwane stałe

Obsługiwane operatory

Obsługiwane funkcje

Ogólne funkcje matematyczne

Funkcje trygonometryczne

Funkcje wykładnicze i logarytmiczne

Funkcje zaokrąglania, obcinania i reszty

Funkcje statystyczne / agregujące

Operacje na ciągach znaków

Rozpoznawanie łańcucha znaków

Łączenie łańcuchów znaków

konwersja łańcuchów znaków

Formatowanie łańcucha znaków

Funkcje tworzenia obiektów

Funkcje wektorów

Funkcje macierzy

Wyrażenia warunkowe

Jednostki

Ilość materii

Kąt

Prąd

Pojemność elektryczna

Ładunek elektryczny

Przewodnictwo elektryczne

Indukcyjność elektryczna

Potencjał elektryczny

Opór elektryczny

Energia / praca

Siła

Długość

Natężenie światła

Strumień magnetyczny

Gęstość strumienia magnetycznego

Masa

Siła

Ciśnienie

Temperatura

Czas

Objętość

Specjalne jednostki brytyjskie

Jednostki nieobsługiwane

Nieprawidłowe znaki i nazwy

Etykiety

Nazwy

Przypisania do komórek

Odwołanie do danych CAD

Zależności cykliczne

Zmienne globalne w obrębie dokumentu

Powiązania między dokumentami

Znane problemy / niezrealizowane zadania

Tworzenie skryptów

dane CAD	Odwołanie do wyrażenia	Wynik
Parametr długości sześcianu środowiska pracy Część	`Cube.Length`	Długość w mm
Objętość sześcianu	`Cube.Shape.Volume`	Objętość w mm³ bez jednostek
Typ kształtu sześcianu	`Cube.Shape.ShapeType`	String: Bryła
Etykieta sześcianu	`Cube.Label`	String: Etykieta
Współrzędna x środka masy sześcianu	`Cube.Shape.CenterOfMass.x`	Współrzędna x w mm, bez jednostek
Składowa X osi obrotu umiejscowienia Sześcianu	`Box.Placement.Rotation.Axis.x`
Kąt obrotu dla umiejscowienia Sześcianu	`Box.Placement.Rotation.Angle`	Kąt obrotu w jednostkach (deg)
Pełny obiekt Sześcianu	`Box._self`	Obiekt typu <Part::PartFeature>.
Wartość wiązania w szkicu	`Constraints.Width`	Wartość numeryczna nazwanego wiązania `Width` w szkicu, jeśli wyrażenie jest używane w samym szkicu.
Wartość wiązania w szkicu	`MySketch.Constraints.Width`	Wartość numeryczna nazwanego wiązania `Width` w szkicu, jeśli wyrażenie jest używane poza szkicem.
Wartość aliasu arkusza kalkulacyjnego	`Spreadsheet.Depth`	Wartość aliasu `Depth` w arkuszu kalkulacyjnym `Spreadsheet`
Wartość lokalnej właściwości	`Length`	Wartość właściwości DANELength np. w obiekcie Pad, jeżeli wyrażenie jest użyte np. w DANELength2 w tym samym obiekcie.